home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / PROGSCAL / PULL21.LZH / PULLDEMO.ARC / READ.ME < prev   
Text File  |  1989-05-29  |  15KB  |  312 lines
  1.  
  2.     PULL Multi-level Pull-Down Menus                 Read.Me, Version 5.Xc
  3.  
  4.  
  5.                            MULTI-LEVEL PULL-DOWN MENUS
  6.                                   DEMONSTRATION
  7.  
  8.                                   Version 5.Xc
  9.                                   May 29, 1989
  10.  
  11.  
  12.                 Copyright (C) 1987-1989 Eagle Performance Software
  13.                                All Rights Reserved
  14.  
  15.  
  16.                               ┌─────────┐
  17.                         ┌─────┴───┐     │              (tm)
  18.                       ──│         │o    │──────────────────
  19.                         │   ┌─────┴╨──┐ │  Association of
  20.                         │   │         │─┘  Shareware
  21.                         └───│    o    │    Professionals
  22.                       ──────│    ║    │────────────────────
  23.                             └────╨────┘    MEMBER
  24.  
  25.  
  26.    Welcome to PULL - high performance environment software for Turbo Pascal
  27.    and Turbo C!
  28.  
  29.    PULLDEMO.EXE - Simply execute the program.  The instructions are on the 
  30.    screen in window 4.  Press Alt-1 to Alt-4 to access the corresponding work
  31.    window.  To quit, Alt-X at anytime.
  32.  
  33.  
  34.    INSTRUCTIONS:
  35.  
  36.    Familiar Environment - You will probably feel right at home with the
  37.    environment created with PULL as it appears very similar to the TP5
  38.    editor.  It is interesting to note that PULL was developed with TP3
  39.    before TP4 was ever released.  However, you should find the operation
  40.    quite similar.  While you are running the demo, let's get familiar with
  41.    the format and operation of the environment and follow along with this
  42.    overview.  Most of it should be intuitive, but there are some finer
  43.    features that you may not want to miss.
  44.  
  45.      . Status Line - Row 1 just holds the title of this program.  It is
  46.        optional.
  47.  
  48.      . Top Line Menu - Row2 has been optionally assigned to be the top
  49.        line menu.  Press F10 at any time to access it.
  50.  
  51.      . Work Window - For this demo, Rows 4 to 23 has a 20x78 window for
  52.        the major part of your input/output.  You can also have several
  53.        other windows like this demo for a multi-level window
  54.        environment.
  55.  
  56.      . Main Menu - To access a main menu, press RETURN or a command 
  57.        letter (LTR) while the top line menu is highlighted on any 
  58.        selection.  Or, you can use a combination of the ALT key and a 
  59.        letter, such as Alt-F to get to the File menu.
  60.  
  61.      . Submenu - A submenu is a menu under a Main Menu.  To access a 
  62.        submenu, press RETURN when the HiLite is at a menu line with the 
  63.        three-bar symbol (which looks like a menu).  You can see three 
  64.        levels of menus by pressing Alt-A/Tires/Brands.
  65.  
  66.    Local Keys and Letter Commands - While a window is shown, several keys 
  67.    operate for just that window.  These keys can be listed in the message 
  68.    line or they can be assumed to be the command letters highlighted on each 
  69.    menu line.
  70.  
  71.      . Help Windows (F1) - While the Brands menu is still showing, 
  72.        press F1 to get context-sensitive help.  A help window is 
  73.        assigned to every window and menu.
  74.  
  75.      . Keys on Message Line - The bottom line of the CRT, being closest 
  76.        to the keyboard, indicates the available keys that can be used 
  77.        for the current context.  It is also used for help or error 
  78.        messages.  While the help window is displayed, the next key 
  79.        pressed will also pass through as a command.  For instance, press 
  80.        RETURN now and see the help window removed and Firestone will 
  81.        also become flagged.
  82.  
  83.      . Pop and Pull (F2) - F2 is a pop-and-pull key that toggles between 
  84.        the pull-down menus and the work window.  Press F2 twice and you 
  85.        will see that it remembers the last menu that was pulled.
  86.  
  87.      . Command Letters (LTR) - If you wanted to select WeatherGuard on 
  88.        the Brands menu, just type the letter "W" which is highlighted.  
  89.        These letters will work in any menu.
  90.  
  91.      . Cursor Keys - All of the cursor keys like the arrows, Home and 
  92.        End keys, have assigned functions as well as the control-shifted 
  93.        cursor keys.  You can discover what they do by experimenting with 
  94.        them in a menu.
  95.  
  96.      . ESC Key - The ESC key always backs out of the current menu/window.
  97.  
  98.    Global Keys - Extended key combinations can be used to access any part of 
  99.    the program.  In this demo, some have been assigned with the ALT key.  
  100.    Press down ALT for a half second and see the available global keys listed 
  101.    on the message line.
  102.  
  103.      . Directory (Alt-D) - Press Alt-D now to get a directory of your 
  104.        disk.  If you would like to continue testing the directory, press 
  105.        F1 for instructions.
  106.  
  107.      . Exit (Alt-X) -  To exit the program, one alternative is to use 
  108.        Alt-X, but don't do it now.
  109.  
  110.      . Top Line Menu (F10) - As mentioned before, to get to the top line 
  111.        menu, press F10 at any time.
  112.  
  113.    Data Entry Windows - Each menu can additionally pull down a data entry 
  114.    window which is indicated with a small dot symbol on the menu line.  
  115.    These windows are fully configurable and have full editing capability.  
  116.    They have a free-field entry concept where a entire string is typed and
  117.    edited before entering.  Let's try a few fields.
  118.  
  119.      . Data Entry Types - Press Alt-E to see a menu of all the data 
  120.        entry types available.  Press RETURN when the HiLite is at a menu 
  121.        line with a small dot symbol.  Pressing RETURN again will exit 
  122.        the window entering the data shown.  You can clear any data 
  123.        entered by pressing ESC which also removes the window.
  124.  
  125.      . Editing - Press "I" while the main menu is still shown and enter 
  126.        a value for the integer.  The virgin entry is highlighted until 
  127.        you press a key.  The entry has full edit capability using the 
  128.        cursor keys and some familiar WordStar control keys.  Press F1 
  129.        for a list.  Even the insert mode is indicated with a half-block 
  130.        cursor.
  131.  
  132.      . Options - All sorts of options are available for these windows 
  133.        including range checking, fixed and flex fields, character 
  134.        control and translation, automatic NumLock, justification, 
  135.        titles, and attributes.
  136.  
  137.    Work Window Data Entry - The same procedures used for the data entry
  138.    windows can be used for entering data in the work windows.  In addition, 
  139.    PULL has a smart algorithm that knows where several fields are on the 
  140.    screen.  So moving from field to field with all the cursor keys is 
  141.    intuitive.
  142.  
  143.      . Moving the HiLite - Press Alt-2 to get back to the work window 
  144.        with all of the data entry fields.  One field will be highlighted
  145.        which means it can be moved to select another field.  All of the 
  146.        cursor keys move the HiLite including the control-shifted keys 
  147.        and the Tab and Shift-Tab keys.  Move the HiLite to the Integer 
  148.        field.
  149.  
  150.      . New Values - To enter a new value for the integer, simply start 
  151.        typing some numbers and the HiLite will change colors.  You can 
  152.        see that only numbers and the sign can be entered.  Press RETURN 
  153.        to enter the new value or press ESC to restore the old value.  
  154.  
  155.      . Editing - To edit the value currently shown in a field, press 
  156.        RETURN or any WordStar control key.
  157.  
  158.    Other Features - There are many other features in the menus which will be
  159.    covered later including menu and line modes.  You can discover these by 
  160.    pressing Alt-F and then F1 for a description.  For direct menu control, 
  161.    press Alt-I and then U.  Pressing RETURN at any of the lines 1 through 6 
  162.    will show several possiblities under your control.  Press Alt-X to quit.
  163.  
  164.    Multi-tasking - This demo can easily be set to work in multi-tasking 
  165.    environments by using a file called DESQ5X.ARC.  It is a simple matter of
  166.    setting the video buffer pointer.  This demo does not include this file.
  167.  
  168.  
  169.    OTHER PRODUCTS
  170.  
  171.    Eagle Performance Software has developed identical products for both 
  172.    Turbo C and Turbo Pascal.  Our pledge is to provide you quality products 
  173.    with unparalleled performance and ease of use.  All registered users 
  174.    receive the complete source code.  Here is a list of other products:
  175.  
  176.  
  177.    QWIK - For direct screen video, QWIK is the highest performance screen 
  178.    writing tools available today for all text modes in any video 
  179.    configuration.  QWIK provides capabilities far beyond in the unit/library
  180.    that comes with your compiler.   Here are some of the features:
  181.                    
  182.      - Writes on all IBM compatible computers, displays and adapters 
  183.        including MDA, CGA, EGA, MCGA, VGA, 8514/A, Hercules and 3270 PC.
  184.      - Superior video detection routine.
  185.      - Eliminates snow and flicker.
  186.      - Writes directly to the screen in absolute rather than relative
  187.        coordinates.
  188.      - Writes in all text modes and column modes.
  189.      - Writes on all video pages.
  190.      - Writes on virtual screens in RAM.
  191.      - Writes text and attribute, text only, or attribute only.
  192.      - Reads strings, characters and attributes.
  193.      - Uses End-Of-String (EOS) marker for quick string chaining.
  194.      - Provides standardized cursor shapes for all adapters.
  195.      - Enhanced cursor movement.
  196.      - Compatible with DESQview and similar multitasking environments.
  197.      - Over 650+% faster than standard direct screen writing.
  198.      - Only 2.7k bytes of code if all 45 utilities are used.
  199.      - Writes direct to multi-tasking video buffers (MTVB).
  200.      - Optimized by the compiler and drops unused code.
  201.      - Used in all other Eagle products.
  202.      - Excellent documentation.
  203.  
  204.    Here are the product versions:
  205.  
  206.       File name    CIS Name    Compiler  Release date
  207.       -----------  ----------  --------  ------------
  208.       QWIK42C.ARC  QWIK42.ARC  TP4(TP5)   10-01-88
  209.       QWIK5XA.ARC  QWIK5X.ARC  TP5(TP4)   12-20-88
  210.       QWIKC20.ARC  QWKC20.ARC  TC2        12-03-88
  211.  
  212.  
  213.    WNDW - For multi-level virtual windows, WNDW is the highest performance 
  214.    window utilities available today.  It offers very powerful utilities for 
  215.    full window control and management you probably never thought possible.   
  216.    They are simple and yet very powerful with high speed and tight code.  
  217.    With WNDW, you can choose the absolute writing routines of QWIK, the 
  218.    window-relative writing routines of WNDW, and even customize your own.  
  219.    Here are some of the features you will discover:
  220.  
  221.      - Uses the powerful direct screen writing routines of QWIK.
  222.      - Up to 254 fixed or virtual windows can be on the screen at one 
  223.        time.
  224.      - Extremely high-speed virtual screens in RAM (up to 40 times 
  225.        faster).
  226.      - Virtual windows are fully updated on screen, even if covered.  
  227.        Screens can scroll underneath one another right on the screen at 
  228.        very high speeds!
  229.      - Virtual windows have virtual titles.                                
  230.      - Fully supported hidden windows saved in RAM.                        
  231.      - Fully supports all video pages.                                     
  232.      - Adjustable-rate moving, resizing, and scrolling.                    
  233.      - All windows can be randomly accessed, not just stacked or tiled.    
  234.      - 28 window-relative writing routines.                                
  235.      - 15 different border styles with shadow and zoom effects.            
  236.      - Full line drawing procedures.                                       
  237.      - Full cursor mode control for each window.                           
  238.      - Writes in all text modes and column modes.                          
  239.      - Only 13k bytes of code if all 69 utilities are used.                
  240.      - Writes direct to multi-tasking video buffers (MTVB).
  241.      - Used in all other Eagle products.
  242.      - Excellent documentation like this document.
  243.  
  244.    Here are the product versions:
  245.  
  246.       File name    CIS Name    Compiler  Release date
  247.       -----------  ----------  --------  ------------
  248.       WNDW42B.ARC  WNDW42.ARC  TP4(TP5)   10-15-88
  249.       WNDW5XC.ARC  WNDW5X.ARC  TP5(TP4)   12-20-88
  250.       WNDWC20.ARC  WNDC20.ARC  TC2        03-15-89
  251.  
  252.  
  253.    PULL - For multi-level pull-down menus, PULL is fully featured and fully
  254.    configurable.  Includes execute, single, and multiple choice menus,
  255.    unlimited nested submenus, data entry windows, help windows, directory
  256.    windows, message system, and fully completed interfaces.  Some of the
  257.    features are:
  258.  
  259.      - Uses QWIK and WNDW.
  260.      - Work window(s) and complete interface for menus
  261.      - Pull-down menus with 3 menu modes and 8 line modes
  262.      - Pull-down file directory
  263.      - Highlighted command letters
  264.      - Unlimited levels of submenus
  265.      - Unlimited data entry windows for 9 types of data
  266.      - Data entry for the work window(s)
  267.         Free field entry with either fixed column or flexible column        
  268.          length.
  269.         Full editing capability including insert cursor mode
  270.         Full field selection with cursor keys
  271.         Automatic NumLock for numerical data entry
  272.         Right or left justification for data entry output
  273.         Error messages for invalid data entries
  274.         Error messages for data entries out of range
  275.      - Automatic sizes and locations for menus.
  276.      - Operation by cursor 
  277.        keys or command keys
  278.      - Pull/Pop between work window and nested submenu(s)
  279.      - Programmable control of pull and pop sequences
  280.      - Context-sensitive help
  281.      - Message lines for prompts and processing
  282.      - Writes direct to multi-tasking video buffers (MTVB).
  283.      - Full working shell for user development
  284.      - Excellent documentation like this document.
  285.  
  286.     Here are the product versions:
  287.  
  288.       File name    CIS Name    Compiler  Release date
  289.       -----------  ----------  --------  ------------
  290.       PULL42B.ARC  PULL42.ARC  TP4(TP5)   01-03-89
  291.       PULL5XC.ARC  PULL5X.ARC  TP5(TP4)   01-07-89
  292.       PULLC20.ARC  PULC20.ARC  TC2        04-15-89
  293.  
  294.  
  295.    ON-LINE SERVICES
  296.  
  297.    CompuServe - All updated files and later versions can be found on the 
  298.    CompuServe Borland Forums (GO BPROGA for TP and GO BPROGB for TC) or the 
  299.    IBM Programming Forum (GO IBMPRO).
  300.  
  301.    The Eagle BBS - You can also get the latest files on our 24-hour BBS at 
  302.    (214) 539-9878, 1200/2400 N81.  
  303.  
  304.    For more information, for Turbo Pascal and C products call or write:
  305.  
  306.        Eagle Performance Software
  307.        TP/TC products
  308.        P.O. Box 292786
  309.        Lewisville, TX  75029-2786
  310.  
  311.    Or, contact Jordan Gallagher at (214)-539-7855 (CIS: 73557,2342).
  312.